home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 038a / fpchk101.zip / FPCHECK.DOC < prev    next >
Text File  |  1993-03-11  |  11KB  |  215 lines
  1.  
  2.          Tips and Tricks for Using the SupraFAXModem with PCB/FaxMail
  3.  
  4.                             by Rod L. Renner, SysOp
  5.                                The Lightning Rod BBS
  6.                                Silver Spring MD 20904
  7.                                BBS: 301-622-0708 (v.32bis)
  8.  
  9. Introduction
  10.  
  11.      I run a PCBoard system using a SupraFAXmodem v.32bis modem.  The modem 
  12.      has worked well with this system, but I have been interested in using its 
  13.      FAX capability as well.  Mark Herring's PCB/FaxMail gateway provided an 
  14.      excellent means to implement this feature, but his program was written 
  15.      primarily for use with Bit Corporation's BitFax software, which does not 
  16.      currently support the Supra modem.  The only DOS based facsimile software 
  17.      program that currently supports the Supra modem is FaxTalk Plus by 
  18.      Thought Communications, Inc.  Fortunately, it has enough of the critical 
  19.      features needed to implement a working FaxMail gateway on the PCBoard 
  20.      system.  
  21.  
  22.      Since BitFax and FaxTalk Plus operate differently, setting up a FaxTalk 
  23.      Plus based system requires several changes in procedure, some of which 
  24.      were determined by trial and error, or by calling Thought Communications' 
  25.      Tech Support line.  It was also necessary to write a customized program, 
  26.      called FPCHECK, to read the FaxTalk Plus log file and report to FaxMail 
  27.      the success or failure of the fax transfer.  A copy of FPCHECK is 
  28.      included in this package.  
  29.  
  30.      In order to use FaxTalk Plus with FaxMail, the user should have read or 
  31.      reviewed the documentation that accompanies both products.  These notes 
  32.      are intended to point out key settings or techniques which can be used to 
  33.      make the FaxMail/FaxTalk combination work.  
  34.  
  35. FaxTalk Plus Installation and Configuration
  36.  
  37.      Install the FaxTalk Plus programs following directions in the FaxTalk 
  38.      documentation and FaxMail instructions.  These examples assume that the 
  39.      FaxTalk Plus software is installed in C:\PCB\FAX and that the location of 
  40.      the WORK directory for outgoing messages, including those converted to a 
  41.      FaxTalk format, is C:\FAXOUT.  If you use a different directory, please 
  42.      adjust these instructions accordingly.  There are several important 
  43.      settings that must be used if it to be successful.  
  44.  
  45.      CONFIGURE option in the FINSTALL program.
  46.  
  47.           o   NOTE that FaxTalk Plus requires that the modem return numeric 
  48.               result codes ('V0' setting in the 'Modem Init String') rather 
  49.               than word result codes which are required by PCBoard.  Before 
  50.               returning to PCBoard, the modem must be reset to its original 
  51.               settings for PCBoard by sending an ATZ command; otherwise, 
  52.               PCBoard will not be able to communicate with the modem.  This 
  53.               can be done with a simple ECHO command or by running a shareware 
  54.               program such as ATSEND.  
  55.               
  56.      CONFIG options in the FAXPLUS program.
  57.      
  58.           o   Under the 'SYSTEM' menu, be sure to set the following critical 
  59.               options: 
  60.  
  61.               Background Operation [Y/N]                         - N
  62.               Automatic Answering [Y/N]                          - N
  63.               Number of Time(s) to Try Dialing [1-8]             - 1
  64.               Error Correction Mode Enabled [Y/N]                - N
  65.               Send File Directory                - C:\FAXOUT
  66.  
  67.               Background Operation must be set to [N]o in order to insure that 
  68.               the program waits while the fax is sent and control is not 
  69.               allowed to proceed until completion or failure.  Since this is a 
  70.               send-only system, Automatic Answering should be set to [N]o.  
  71.               The Number of Time(s) to Try Dialing MUST be set to [1] time!!  
  72.               If this number is set higher than 1 and the transmission fails, 
  73.               FaxTalk would automatically schedule it for retransmission, but 
  74.               allow control to continue resulting in unpredictable, but 
  75.               undesirable consequences!  Due to a firmware error with the 
  76.               Supra modem (according to Thought Communications) and by 
  77.               frustrating trial-and-error on my part, Error Correction Mode 
  78.               must be Disabled ([N]o).  Enabling ECM causes the fax program to 
  79.               hang up unexpectedly after transmitting one page or less and to 
  80.               report a transfer failure.  Finally, the Send File Directory may 
  81.               be set to point to the location of the WORK directory for FaxMail.
  82.  
  83.           o   Under the 'CONVERT' menu, set the following option:
  84.  
  85.               Delete Converted Images After Sending [Y/N]          - Y
  86.  
  87.               This setting will cause the FaxTalk converted images to be
  88.               deleted after they are sent, as there is no need to keep them
  89.               around.  FaxMail will take care of deleting the original ASCII
  90.               test file.
  91.  
  92.      Other settings are at the users discretion or at the suggestion of the 
  93.      FaxTalk software.
  94.  
  95. FaxMail Main Menu Selections
  96.  
  97.      Paths & Filenames
  98.  
  99.           Name/Loc of the WORK file................. C:\FAXOUT\WORK
  100.  
  101.                The path chosen should match the Send File Directory setting as 
  102.                used when configuring FaxTalk Plus SYSTEM menu.  I recommend 
  103.                that the filename (WORK) NOT contain a file extension.  This 
  104.                allows FaxTalk to create the pages of converted images with 
  105.                filenames WORK.001, WORK.002, etc.  This will also be the 
  106.                directory in which FaxTalk writes its log file (SEND.LOG).  
  107.  
  108.           Fax Software DOS command.................. RUNFAX %FILE %PHONE
  109.  
  110.                In the C:\PCB\FAX directory, create a BATch file called 
  111.                RUNFAX.BAT which contains the following commands: 
  112.  
  113.                     CONVERT %1 /e /f
  114.                     SENDAFAX %1 %2
  115.  
  116.                These two FaxTalk programs convert the %FILE file passed by 
  117.                FaxMail (C:\FAXOUT\WORK) into faxable images (WORK.001 etc.), 
  118.                then sends the converted image to the recipient fax at the 
  119.                phone number.  '/e' tells CONVERT that WORK file is ASCII text 
  120.                while '/f' selects fine resolution.  
  121.           
  122.           Fax Software VERIFY command........  FPCHECK C:\FAXOUT\SEND.LOG
  123.  
  124.                FPCHECK.EXE is a customized program that will read the last
  125.                entry in the log file created by SENDAFAX, then create the
  126.                file named "OK" in the current directory to report the status
  127.                (SUCCESS, BUSY, or NOGOOD) back to the FaxMail gateway.  Be
  128.                sure to copy FPCHECK.EXE included in this package into the
  129.                C:\PCB\FAX directory.
  130.  
  131.           Cycle count for temporary work files................. 0
  132.  
  133.                Set this value to 0 as each fax will be processed before the
  134.                next one is sent.
  135.  
  136.           Use other values as suggested in the FaxMail documentation for
  137.           Paths & Filenames.
  138.  
  139.      Fax Type Definitions
  140.  
  141.           The *TYPE: and *INCLUDE: commands are probably not available with
  142.           the FaxTalk program unless the user can think of a clever way to
  143.           convert an uploaded file into a FaxTalk file and imbed into the
  144.           message the appropriate '&&filename' statement as outlined in the
  145.           FaxTalk manual.
  146.  
  147. FAX.BAT or $$LOGOFF.BAT files
  148.  
  149.      The sequence of commands for running the FaxMail gateway using a sample
  150.      FAX.BAT file would look something like this:
  151.  
  152.           CD \PCB\FAX          <- Make this the default directory
  153.           FAXTSR /l            <- Loads FAXTSR into memory
  154.           FAXMAIL /SCAN        <- Run FaxMail gateway
  155.           FAXTSR /u            <- Unload (remove) FAXTSR from memory
  156.           ECHO ATZ >COM1       <- Reset the modem!! (Use the right COM port)
  157.           CD \PCB              <- Change back to \PCB directory
  158.           BOARD                <- Rerun PCBoard
  159.  
  160.      NOTE the 'ECHO ATZ >COMx' command.  It is VERY IMPORTANT to include a
  161.      command to reset the modem on its COM port back to its PCBoard settings,
  162.      particularly the use of word result codes, otherwise PCBoard will be
  163.      unable to communicate with the modem and will fail to recycle properly.
  164.      It is also OK to use a shareware program such as ATSEND to accomplish
  165.      this.
  166.  
  167. Tricks on Rescheduling a Failed Fax Connection
  168.  
  169.      Occasionally, the SupraFAX fails to make a connection with a remote fax 
  170.      machine on the first try.  Because FaxTalk must be told not to redial the 
  171.      number, the reported NOGOOD prevents it from being retried.  However, 
  172.      there is a way to have the attempt tried several times through clever use 
  173.      of options.  FPCHECK has the '/B' option which will report a 'Failed' 
  174.      attempt as a BUSY rather than a NOGOOD.  FaxMail will mark these messages 
  175.      as BUSY, which can then be retried, rather than as Failed which stops 
  176.      further attempts.  By setting up two configuration files for FaxMail 
  177.      using the /CFG= option (one calling FPCHECK with the /B option and the 
  178.      second without the /B), FaxMail can be called several times in a row to 
  179.      retry Failed connections.  Here is a sample EVENT.SYS file that 
  180.      illustrates the technique: 
  181.  
  182.           CD \PCB\FAX                    <- Make this the default directory
  183.           FAXTSR /l                      <- Loads FAXTSR into memory
  184.           FAXMAIL /SCAN /CFG=WITHB       <- Run FaxMail marking Failed as Busy
  185.           FAXMAIL /BUSY /CFG=WITHB       <- Rerun FaxMail for Busy or Failed
  186.           FAXMAIL /BUSY /CFG=WITHOUTB    <- Try a third time but allow Failures
  187.           FAXTSR /u                      <- Unload (remove) FAXTSR from memory
  188.           ECHO ATZ >COM1                 <- Reset the modem!!
  189.           CD \PCB                        <- Change back to \PCB directory
  190.           BOARD                          <- Rerun PCBoard
  191.  
  192.      Note that the last call to FaxMail makes certain that messages which fail 
  193.      3 times (or were BUSY then fail twice) do not continue to be marked BUSY.
  194.  
  195. Final Notes
  196.  
  197.      This information and the FPCHECK program were tested with FaxMail 1.01
  198.      and FaxTalk Plus v1.65C using a SupraFAXmodem V.32bis modem with the
  199.      "J" (Caller ID) chip.  
  200.  
  201.      Good luck and success in using the FaxMail door with FaxTalk Plus and
  202.      the SupraFAXmodem!  I imagine there may be better ways to implement
  203.      this combination, but I find this does work quite adequately.  Feel free
  204.      to experiment.
  205.  
  206.      I offer this information and programs for free and on an AS IS basis!
  207.      There is ABSOLUTELY NO WARRANTIES OR GUARANTEES OF ANY KIND associated
  208.      with the use of this information or programs.  USE ENTIRELY AT YOUR OWN
  209.      RISK AND EXPENSE.
  210.  
  211.      FaxMail 1.01 is Copyright 1993 by Mark Herring.
  212.      SupraFAXmodem is a tradeMark of the Supra Corporation.
  213.      FaxTalk is a registered trademark of Thought Communications, Inc.
  214.  
  215.